home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / XLIBP202.ZIP / README.DOC < prev    next >
Text File  |  1995-01-26  |  9KB  |  180 lines
  1. ╔═══════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                           ║
  3. ║        XLIB v2.02 - Graphics Library for Borland/Turbo Pascal 7.0          ║
  4. ║                                                                           ║
  5. ║               Tristan Tarrant - tristant@cogs.susx.ac.uk                  ║
  6. ║                                                                           ║
  7. ╠═══════════════════════════════════════════════════════════════════════════╣
  8. ║                                                                           ║
  9. ║                                 Credits                                   ║
  10. ║                                                                           ║
  11. ║                             Themie Gouthas                                ║
  12. ║                                                                           ║
  13. ║                            Matthew MacKenzie                              ║
  14. ║                                                                           ║
  15. ║                             Tore Bastiansen                               ║
  16. ║                                                                           ║
  17. ║                                 Andy Tam                                  ║
  18. ║                                                                           ║
  19. ║                               Douglas Webb                                ║
  20. ║                                                                           ║
  21. ║                              John  Schlagel                               ║
  22. ║                                                                           ║
  23. ╠═══════════════════════════════════════════════════════════════════════════╣
  24. ║                                                                           ║
  25. ║           I informally reserve all rights to the code in XLIB             ║
  26. ║       Rights to contributed code is also assumed to be reserved by        ║
  27. ║                          the original authors.                            ║
  28. ║                                                                           ║
  29. ╚═══════════════════════════════════════════════════════════════════════════╝
  30.  
  31. ╔═══════════════════════════════════════════════════════════════════════════╗
  32. ║ DISCLAIMER                                                                ║
  33. ╚═══════════════════════════════════════════════════════════════════════════╝
  34.  
  35.     This library is distributed AS IS. The author/s specifically disclaim any
  36.     responsibility for any loss of profit or any incidental, consequential or
  37.     other damages.
  38.  
  39. ╔═══════════════════════════════════════════════════════════════════════════╗
  40. ║ IMPORTANT NOTICE                                                          ║
  41. ╚═══════════════════════════════════════════════════════════════════════════╝
  42.  
  43.     Hi Xlib users, this is v2.02 of my port of XLib to Turbo/Borland Pascal.
  44.     I would like to state a few things before you start using this package :
  45.     
  46.     I have ported all the useful stuff from Xlib for C v6.0, and added a few
  47.     things of my own, apart from cleaning up the code and making it more
  48.     Pascal-friendly.
  49.  
  50.     If there is any code you have written that you think is worth including in
  51.     the next release, don't hesitate to send it to me and you will receive due
  52.     credit.
  53.  
  54.     I have had a look at the new Xlib for C (6.11+) and the only addition it
  55.     has is support for Windoze. What a pile o' shit. I am not going to add that
  56.     feature (bug?) in Xlib for TP/BP.
  57.  
  58.     Sorry if this isn't up to your expectations but, hey, don't forget : XLIB
  59.     is a user supported library, so send me your code and let's write the
  60.     ultimate XMode game !!!
  61.  
  62.     Share and enjoy.
  63.  
  64. ╔═══════════════════════════════════════════════════════════════════════════╗
  65. ║ BUGS AND REVISIONS                                                        ║
  66. ╚═══════════════════════════════════════════════════════════════════════════╝
  67.  
  68.     The SplitScreen routines weren't handled by the Virtual VSync handler,
  69.     sometime resulting in the program waiting twice for a vsync, and causing
  70.     a choppy effect when scrolling the split screen.
  71.     Now the mouse handler uses the VVH to redraw the pointer
  72.     when necessary. Unfortunately it takes a bit too long and, if you are
  73.     updating the whole palette AND using the mouse at the same time, you'll
  74.     notice that the tip of the pointer disappears for an instant when it's at
  75.     the top of the screen.
  76.     The palette-updating part of the VVH has been sped up a bit.
  77.  
  78.     I have implemented 32-bit compiled bitmaps, even though they are bigger and
  79.     (on my machine) slightly slower than normal CBMs. Maybe on VLB/PCI machines
  80.     this isn't the case.
  81.  
  82.     Protected mode is still at an experimental stage, but it can do quite a few
  83.     things already.
  84.     Things that don't work (or are a bit odd) in protected mode are :
  85.  
  86.     - The Virtual VSync handler (self-modification works, but the rest doesn't)
  87.     - VBM's on my machine are faster in pmode (??!?!?!)
  88.     - I assume that the ROM font is at segment 0C000h because that's where the
  89.             Video BIOS usually is. I have tested it on a Paradise (WD90c30), a
  90.             Cirrus Logic (CL-54xx) and a Trident (9000i) with no problems. If you
  91.             find some board that doesn't work please report it (though I don't know
  92.             why you'd want to use ROM BIOS fonts anyway :-)
  93.     - The palette scrolling in the XLIBDEMO is tooooooo slow...
  94.  
  95.     If you find a way of fixing these, or if you find more routines that don't
  96.     like protected mode, email me please.
  97.  
  98. Release v2.01
  99.  
  100.     XConvert was broken. Fixed.
  101.     XLArc and XLA2 were broken in DPMI. Fixed.
  102.     Added file viewing in XLArc.
  103.     If you want to know how to do CBMs in DPMI, read BLITDEMO.PAS.
  104.     Makefile fixed.
  105.     Bugfixes here and there.
  106.  
  107. Release v2.02
  108.  
  109.     Fixed clipping code. Now all clipping routines should not crash when 
  110.     displaying bitmaps that were allocated in areas of memory other than the
  111.     data segment.
  112.  
  113. ╔═══════════════════════════════════════════════════════════════════════════╗
  114. ║ NOTES                                                                     ║
  115. ╚═══════════════════════════════════════════════════════════════════════════╝
  116.  
  117.     A good idea for debugging programs that use XLib is to use Colin Buckley's
  118.     UNCHAIN v2.1 program. The code for saving the screen information is built
  119.     in the xsetmode function, but if you don't use UNCHAIN it should not make
  120.     any difference.
  121.  
  122. ╔═══════════════════════════════════════════════════════════════════════════╗
  123. ║ APPLICATIONS THAT USE XLIB FOR TP/BP                                      ║
  124. ╚═══════════════════════════════════════════════════════════════════════════╝
  125.  
  126.     I have decided to start a list of applications that have been written using
  127.     a version of XLibPas, and where they can be found. Please mail me any
  128.     additions.
  129.  
  130.  
  131.     Chromatiks - The world's first multi-group music disk. Coordinated by
  132.         Trixter (Jim Leonard).
  133.  
  134.             Site      : wasp.eng.ufl.edu
  135.             Directory : /pub/msdos/demos/music/disks
  136.             Filename  : chromat*.zip
  137.  
  138.     WadManager v1.50 - A GUI WAD manager for DOOM. Written by Tristan Tarrant.
  139.  
  140.             Site      : infant2.sphs.indiana.edu
  141.             Directory : /pub/doom/misc
  142.             Filename  : wm150.zip
  143.  
  144. ╔═══════════════════════════════════════════════════════════════════════════╗
  145. ║ CREDITS AND THANKS                                                        ║
  146. ╚═══════════════════════════════════════════════════════════════════════════╝
  147.  
  148.         Michael Abrash - The guy who started it all in the first place
  149.  
  150.         Themie Gouthas - The original maintainer of the XLIB for C library
  151.  
  152.         Matthew McKenzie - Compiled blits, circles and clipping. What more could
  153.             I say
  154.  
  155.         Tore Bastiansen - For the Virtual VSync handler : a true masterpiece
  156.  
  157.         Andy Tam - For the LZS encoding/decoding routines
  158.  
  159.         Douglas Webb - For collecting loads of compression algorithms
  160.  
  161.         John Schlagel - For the bitmap scaling code
  162.  
  163.         iD Software - For giving me inspiration for XLAs
  164.  
  165.         Jim Leonard - For beta-testing this beast
  166.  
  167.         Colin Buckley - For his UNCHAIN program which made debugging hours so much
  168.             easier
  169.  
  170.         Kai Rohrbacher - Author of ANIVGA for including so many fonts in his most
  171.             excellent library
  172.  
  173.         Paul Silver and Aarron Shaughnessy - For letting me test this code on 
  174.             their machines
  175.             
  176.         Borland - For their excellent compiler suite
  177.  
  178.         Anybody on USENET who sent me suggestions
  179.  
  180.